W09-1. ConfigMap · Secret · PV/PVC - 강의 노트

9주차 강의 노트: ConfigMap · Secret · PV/PVC (방명록을 Kubernetes 로 이전)

이번 주 목표

  1. 설정을 이미지와 분리해야 하는 이유를 알고, ConfigMap 으로 설정을 넘길 수 있다.
  2. Secret 의 용도와 한계(암호화가 아니라 인코딩)를 안다.
  3. PV / PVC / StorageClass 로 데이터를 Pod 밖에 영구 저장하는 구조를 설명할 수 있다.
  4. 5주차 Compose 의 웹 + DB 를 Kubernetes 로 옮길 수 있다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • Service 가 Pod 3개로 요청을 나눠 보내고, Gateway API 로 guestbook.localhost 공개
  • 문제: 메모리 저장이라 Pod 마다 글이 달랐다 → 오늘 PostgreSQL 로 해결


1. 오늘 만들 구조

5주차 Compose 로 만든 것을 Kubernetes 오브젝트로 옮깁니다.

flowchart TB
    U["브라우저
guestbook.localhost"] --> GW["Gateway + HTTPRoute
(8주차)"] GW --> SVC["Service: guestbook"] SVC --> W1["방명록 Pod"] SVC --> W2["방명록 Pod"] SVC --> W3["방명록 Pod"] CM["📄 ConfigMap
guestbook-config
DB_HOST, DB_NAME …"] -. "환경 변수" .-> W1 SEC["🔑 Secret
postgres-secret
비밀번호"] -. "환경 변수" .-> W1 W1 & W2 & W3 -- "postgres:5432" --> PSVC["Service: postgres"] PSVC --> DB["PostgreSQL Pod"] SEC -. "환경 변수" .-> DB DB --- PVC["💾 PVC: postgres-data
(1Gi)"] PVC --- PV["PV (자동 생성)"]
5주차 Compose 9주차 Kubernetes
services: web Deployment guestbook + Service guestbook
services: db Deployment postgres + Service postgres
environment: ConfigMap (일반 설정) + Secret (비밀번호)
.env 의 DB_PASSWORD Secret
volumes: db-data PersistentVolumeClaim
depends_on + healthcheck readinessProbe (준비된 Pod 만 Service 에 들어감)
ports: "8080:8000" Service + Gateway/HTTPRoute

2. 설정을 이미지와 분리하는 이유

이미지에 설정을 넣으면 설정을 분리하면
개발 / 테스트 / 운영마다 이미지를 따로 만들어야 함 같은 이미지를 환경마다 다른 설정으로 실행
비밀번호가 이미지 안에 남아 누구나 꺼내 볼 수 있음 비밀번호는 클러스터에만 보관
설정 하나 바꾸려고 다시 빌드 설정만 바꾸고 재시작
실무 원칙 (Twelve-Factor App)

"설정은 환경에 저장하라." 코드와 이미지는 어디서나 같고, 환경마다 다른 값은 환경 변수로 넘긴다. 4주차 ENV + -e, 5주차 .env 가 같은 생각입니다.


3. ConfigMap: 일반 설정

apiVersion: v1
kind: ConfigMap
metadata:
  name: guestbook-config
data:
  APP_VERSION: "v2-k8s"
  DB_HOST: "postgres"        # DB 의 Service 이름 (8주차 DNS)
  DB_NAME: "guestbook"
  DB_USER: "guest"

Pod 에 넘기는 방법:

방법 YAML 결과
통째로 envFrom: - configMapRef: name: guestbook-config 모든 키가 같은 이름의 환경 변수로
하나씩 env: - name: X valueFrom: configMapKeyRef: … 고른 키만
파일로 volumes 의 configMap + volumeMounts 키 = 파일 이름, 값 = 파일 내용 (설정 파일을 통째로 넣을 때)
ConfigMap 을 바꿔도 실행 중인 Pod 의 환경 변수는 그대로입니다 (실제 확인)

환경 변수는 Pod 가 시작될 때 한 번 읽습니다. ConfigMap 을 고친 뒤에는
kubectl rollout restart deployment/guestbook 으로 Pod 를 새로 띄워야 반영됩니다.
(파일로 마운트한 경우는 잠시 뒤 파일 내용이 자동으로 바뀝니다. 앱이 파일을 다시 읽어야 합니다.)


4. Secret: 민감한 설정

apiVersion: v1
kind: Secret
metadata:
  name: postgres-secret
type: Opaque
stringData:
  POSTGRES_PASSWORD: guestpw     # 평문으로 쓰면 저장할 때 base64 로 바꿔 줌
항목 설명
쓰는 법 ConfigMap 과 거의 같음 (secretKeyRef, secretRef)
stringData vs data stringData 는 평문으로 쓰기, data 는 base64 로 인코딩한 값으로 쓰기
기본 보호 권한(RBAC)으로 접근 제한, kubectl get 출력에 값이 바로 보이지 않음
Secret 은 암호화가 아니라 인코딩입니다

실습에서 직접 확인합니다.

$ kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'
Z3Vlc3Rwdw==
$ ... | base64 --decode
guestpw

base64 는 누구나 되돌릴 수 있습니다. 그래서 실무에서는:

  • Secret 이 든 YAML 을 Git 에 그대로 올리지 않습니다.
  • 클러스터 저장소(etcd) 암호화를 켜고, RBAC 로 읽을 수 있는 사람을 제한합니다.
  • 외부 비밀 저장소(AWS Secrets Manager, HashiCorp Vault 등)와 연동하는 도구(External Secrets Operator 등)나, Git 에 암호화해서 올리는 도구(Sealed Secrets, SOPS)를 씁니다.

$(변수) 로 조합하기

방명록은 DATABASE_URL 하나를 원합니다. ConfigMap 과 Secret 의 값을 조합해서 만듭니다.

          envFrom:
            - configMapRef:
                name: guestbook-config            # DB_USER, DB_HOST, DB_NAME …
          env:
            - name: DB_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: postgres-secret
                  key: POSTGRES_PASSWORD
            - name: DATABASE_URL
              value: "postgresql://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):5432/$(DB_NAME)"

실제로 Pod 안에서는 DATABASE_URL=postgresql://guest:guestpw@postgres:5432/guestbook 이 됩니다(실습에서 확인).
$(이름) 은 앞에서 정의된 환경 변수를 가리킵니다.


5. 데이터 저장: PV · PVC · StorageClass

Pod 는 언제든 지워지고 다른 노드에서 다시 생깁니다. DB 데이터는 Pod 밖의 저장소에 있어야 합니다(3주차 볼륨과 같은 생각).

flowchart LR
    P["Pod (PostgreSQL)
/var/lib/postgresql"] -- "volumeMounts" --> C["PVC: postgres-data
'1Gi 필요해요' (요청서)"] C -- "자동 연결 (Bound)" --> V["PV: pvc-4f9c…
실제 저장 공간"] SC["StorageClass: standard
(저장소 공급자)"] -- "요청이 오면 PV 를 자동 생성" --> V
오브젝트 역할 비유 누가 만드나
PVC (PersistentVolumeClaim) "이만큼의 저장소가 필요하다" 는 요청서 주차권 신청서 앱 담당자 (우리)
PV (PersistentVolume) 실제 저장 공간 실제 주차 자리 StorageClass 가 자동으로 (동적 프로비저닝)
StorageClass 어떤 종류의 저장소를 어떻게 만들지 주차장 관리 회사 클러스터 관리자 / 클라우드
StorageClass 의 실제 예 만들어지는 저장소
Docker Desktop: standard (local-path) 노드의 디스크 폴더
AWS EKS: gp3 (EBS CSI) EBS 볼륨
다른 클라우드 각 클라우드의 블록 스토리지
PVC 가 잠깐 Pending 인 것은 정상

Docker Desktop 의 standard 는 WaitForFirstConsumer 방식이라, PVC 를 쓰는 Pod 가 생길 때 PV 를 만듭니다. 그전에는 Pending 입니다(실제 확인).

accessModes

모드 의미
ReadWriteOnce (RWO) 노드 하나에서만 읽기·쓰기 (블록 스토리지, DB 에 일반적)
ReadWriteMany (RWX) 여러 노드에서 동시에 (NFS, EFS 같은 파일 스토리지)
ReadOnlyMany (ROX) 여러 노드에서 읽기만

6. DB 를 Kubernetes 에 올릴 때의 주의점

오늘은 Deployment(replicas 1) + PVC 로 PostgreSQL 을 띄웁니다. 배우기 쉬운 가장 단순한 형태입니다.

설정 이유
replicas: 1 DB 를 여러 개 띄우면 같은 데이터 폴더를 동시에 써서 데이터가 깨집니다
strategy: Recreate 업데이트할 때 옛 Pod 를 먼저 끄고 새 Pod 를 켭니다. 롤링 업데이트(둘이 잠시 동시에 뜸)는 DB 에 위험
readinessProbe: pg_isready DB 가 진짜 준비된 뒤에만 Service 로 트래픽이 가게 함 (5주차 healthcheck 와 같은 역할)
실무에서는?

  • Kubernetes 안에서 DB 를 운영한다면 StatefulSet(Pod 마다 고정 이름과 전용 PVC) 이나 DB 오퍼레이터(CloudNativePG 등)를 씁니다.
  • 많은 경우 클라우드의 관리형 DB(DBaaS: RDS, Cloud DB 등) 를 쓰고, Kubernetes 에는 앱만 올립니다. 백업·이중화·패치를 클라우드가 대신해 주기 때문입니다.
  • SA 관점: "DB 를 클러스터 안에 둘지, DBaaS 로 뺄지" 는 설계에서 꼭 결정할 항목입니다.


핵심 요약

9주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 원칙         설정은 이미지 밖에: 같은 이미지 + 환경별 설정
② ConfigMap    일반 설정 → envFrom / env / 파일 마운트
               바꾼 뒤에는 rollout restart 해야 환경 변수에 반영
③ Secret       민감한 설정. base64 인코딩일 뿐 암호화 아님 → Git 금지, RBAC, 외부 비밀 저장소
④ $(변수)       ConfigMap + Secret 값을 조합해 DATABASE_URL 생성
⑤ 저장소        PVC(요청서) → StorageClass(공급자)가 PV(실제 공간) 자동 생성 → Bound
⑥ DB 운영       replicas 1 + Recreate + readinessProbe (실무: StatefulSet / 오퍼레이터 / DBaaS)

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 8주차 실습 목록으로 9주차 실습 ▶